home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr27 / yacpu.zip / YACPU.DOC < prev    next >
Text File  |  1993-05-24  |  8KB  |  225 lines
  1. ------------------------------------------------------------------------------
  2.             YACPU 1.0 - (C) Copyright 1991-1992 by Anders Ohlsson
  3. ------------------------------------------------------------------------------
  4.  
  5. PROGRAM
  6.  
  7.     YACPU - Yet Another Calendar Printing Utility for HP LaserJet III
  8.  
  9. VERSION
  10.  
  11.     1.0
  12.  
  13. COPYRIGHT
  14.  
  15.     YACPU is (C) copyright 1991-1992 by Anders Ohlsson
  16.  
  17.     YACPU is not public domain, nor shareware, it's "like-ware" (If you like
  18.     it, send me $1, a postcard, or whatever you think it's worth).
  19.  
  20. PURPOSE
  21.  
  22.     YACPU prints a planning calendar for the first or second half year of a
  23.     specified calendar year. Five languages are currently supported (English,
  24.     Swedish, German, French and Spanish). YACPU prints an optional title at the
  25.     top, names of the months, days of the week, and week numbers. Sundays and
  26.     other holidays are highlighted. The calendar sheet consists of 6x31 boxes
  27.     (one for each day of the half year). Non-existing dates are hashed.
  28.  
  29. HISTORY
  30.  
  31.     1.0 Initial release (1991-09-03)
  32.  
  33. AUTHOR
  34.  
  35.     Anders Ohlsson
  36.     Tjadervagen 4
  37.     S-198 00 Balsta
  38.     Sweden
  39.  
  40.     InterNet: ao@elixir.lne.kth.se or
  41.               ao@infovox.se
  42.  
  43. FILES
  44.  
  45.     Files included in this archive are:
  46.  
  47.           YACPU    DOC  7703 bytes      - This file
  48.           YACPU    EXE 13712 bytes      - The executable
  49.           HOLIDAYS TXT   195 bytes      - Sample holiday file
  50.  
  51. SYNTAX
  52.  
  53.     YACPU -y<year> -h<half> [-l<language> -d<device/file> -t<"title">]
  54.  
  55.     Required parameters:
  56.  
  57.       <year>          the calendar year for which you want a calendar printed
  58.       <half>          '1' for January-June or '2' for July-December
  59.  
  60.     Optional parameters:
  61.  
  62.       <language>      'en', 'sw', 'ge', 'fr' or 'sp' (language initials)
  63.       <device/file>   an output device or a filename
  64.       <title>         the title enclosed in quotation marks
  65.  
  66.     Default values:
  67.  
  68.       <language>      English
  69.       <device/file>   PRN
  70.       <title>         the calendar year
  71.  
  72.     (<...> denotes parameter names and [...] denotes optional parameters)
  73.  
  74. NOTES
  75.  
  76.     1. YACPU does not warn you if the output file already exists!
  77.  
  78.     2. The character ' (apostrophe) should not be typed!
  79.  
  80.     3. 'en', 'sw', 'ge', 'fr' and 'sp' stands for English, Swedish, German,
  81.        French and Spanish respectively.
  82.  
  83.     4. Parameters can be typed in any order. You can even specify the same
  84.        parameter more than once (the last overrides the previous ones).
  85.  
  86.     5. You can use "/" instead of "-" as switch character if you wish. You can
  87.        mix them if you like.
  88.  
  89.     6. If you don't specify a title, the year will be printed at the top of the
  90.        calendar sheet. If you don't want a title, nor the year to be printed,
  91.        specify an empty title (i.e. -t"").
  92.  
  93.     7. Quotation marks can be either ", ' or `. Quotes must be closed!
  94.  
  95.     8. ASCII 32-165 except 127,156-159 are currently supported. The width table
  96.        I use is not perfect, see the "SUPPORT" section below. Using characters
  97.        other than ASCII 32-165 may cause unpredictable results.
  98.  
  99.     9. This program is based on the Gregorian calendar. Concerning the intro-
  100.        duction of this calendar system in different countries, please consult
  101.        a history book. It should however work for all Western countries after
  102.        AD 1802.
  103.  
  104. EXAMPLES
  105.  
  106.     Print a calendar for Jul-Dec, 1991 in English:
  107.  
  108.         YACPU -y1991 -h2
  109.  
  110.     Print a calendar for Jan-Jun, 2001 in German:
  111.  
  112.         YACPU -y2001 -h1 -lge
  113.  
  114.     Print a calendar for Jan-Jun, 1995 in English with a title:
  115.  
  116.         YACPU -y1995 -h1 -t"Planning Calendar for 1995"
  117.  
  118.     Print a calendar on COM2:
  119.  
  120.         YACPU -y1991 -h2 -dcom2
  121.  
  122.     Print a calendar on D:\TEST\YACPU.OUT:
  123.  
  124.         YACPU -y1992 -h1 -dd:\test\yacpu.out
  125.  
  126. HOLIDAYS
  127.  
  128.     YACPU looks for a file named "HOLIDAYS.TXT" in the current directory. If
  129.     this file is not found, YACPU says so, but still prints the calendar.
  130.  
  131.     "HOLIDAYS.TXT" is a text file used to specify holidays. Dates specified in
  132.     this file are highlighted on the calendar sheet.
  133.  
  134.     A line in "HOLIDAYS.TXT" could look like this:
  135.  
  136.         0704 4th of July
  137.  
  138.     The first two numbers are the month, the next two are the day. The rest of
  139.     the line is an optional comment (not used by YACPU) i.e. the four leftmost
  140.     character (mmdd) are the only characters needed.
  141.  
  142.     Note 1: Entries must start in the leftmost column!
  143.     Note 2: No checking is done to see if the date is valid or not. (You can
  144.             for instance specify 1232 to highlight the 32nd of December...)
  145.     Note 3: Sundays are highlighted by default, you don't have to specify
  146.             these.
  147.  
  148. SUPPORT
  149.  
  150.     1. If you like this program and want to support it:
  151.  
  152.            Send me $1, a postcard, or whatever you think it's worth.
  153.  
  154.     2. If you want this program to support more languages:
  155.  
  156.            Send me a letter (snail or e-mail) containing the following:
  157.  
  158.                1. The name of the language
  159.                2. The name of the months (January through December)
  160.                3. The name of the days (Monday through Sunday)
  161.                4. The word for "week" (used as a prefix before the week
  162.                   number)
  163.  
  164.     3. If you think that this program is not perfect:
  165.  
  166.            Send me a width table containing the widths of each character in the
  167.            ASCII character set.
  168.  
  169.            (I have one, but the formulas I use are not perfect, which you'll
  170.            probably notice if you use a long title...)
  171.  
  172.     4. If you want more dates to be highlighted by default:
  173.  
  174.            Send me a list containing these dates and how to determine when they
  175.            occur for a given year. E.g. Easter Day is the first Sunday after
  176.            the first full moon after Vernal Equinox, and can be calculated by
  177.            using a mathematical formula (which I don't have at this date,
  178.            please send it if you have it).
  179.  
  180. FORMATS
  181.  
  182.     In Sweden, weeks start on Mondays. If for instance, you want a calendar
  183.     where weeks start on Sundays, drop me a note and I will include this
  184.     feature either as optional or as a language dependent feature.
  185.  
  186. FUTURE
  187.  
  188.     Ability to pre-print text strings on a given date. E.g. print the
  189.     text "4th of July", "Mother's Birthday" and so on.
  190.  
  191.     Support for more languages.
  192.  
  193.     Support for the full extended ASCII character set.
  194.  
  195.     More optional parameters, such as
  196.  
  197.         1. don't print weekdays (Mo...Su)
  198.         2. don't print week numbers
  199.         3. and more...
  200.  
  201. FEED-BACK
  202.  
  203.     If you have any questions/comments relating to this program, please feel
  204.     free to send me mail or e-mail (e-mail is faster).
  205.  
  206.     Anders Ohlsson, Tjadervagen 4, S-198 00 Balsta, Sweden
  207.     InterNet: ao@elixir.lne.kth.se or ao@infovox.se
  208.  
  209. DISCLAIMER
  210.  
  211.     You use this program at your own risk. In no event whatsoever, shall I
  212.     (the author of this program) be held responsible for any damage inflicted
  213.     by this program. (Damage is not very likely to be inflicted, I just want
  214.     to make sure that you don't blame me, should you accidentally overwrite
  215.     some of your other files (by specifying -dC:\COMMAND.COM or something
  216.     like that)).
  217.  
  218. BUGS
  219.  
  220.     If you find any, please let me know, and I will try to fix them.
  221.  
  222. ------------------------------------------------------------------------------
  223.             YACPU 1.0 - (C) Copyright 1991-1992 by Anders Ohlsson
  224. ------------------------------------------------------------------------------
  225.